home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / aio_fsync.z / aio_fsync
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. AAAAIIIIOOOO____FFFFSSSSYYYYNNNNCCCC((((3333))))                                                      AAAAIIIIOOOO____FFFFSSSSYYYYNNNNCCCC((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      aio_fsync, aio_fsync64 - asynchronously synchronize a file's in-memory
  10.      state with that on the physical medium
  11.  
  12. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<aaaaiiiioooo....hhhh>>>>
  14.  
  15.      vvvvooooiiiidddd aaaaiiiioooo____ffffssssyyyynnnncccc((((iiiinnnntttt oooopppp,,,, ssssttttrrrruuuucccctttt aaaaiiiiooooccccbbbb ****aaaaiiiiooooccccbbbbpppp ))));;;;
  16.  
  17.      vvvvooooiiiidddd aaaaiiiioooo____ffffssssyyyynnnncccc66664444((((iiiinnnntttt oooopppp,,,, ssssttttrrrruuuucccctttt aaaaiiiiooooccccbbbb ****aaaaiiiiooooccccbbbbpppp ))));;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The _aaaa_iiii_oooo______ffff_ssss_yyyy_nnnn_cccc_((((_)))) function asynchronously moves all modified data of a file
  21.      indicated by the file descriptor _aaaa_iiii_oooo______ffff_iiii_llll_dddd_eeee_ssss member of the _ssss_tttt_rrrr_uuuu_cccc_tttt _aaaa_iiii_oooo_cccc_bbbb
  22.      referenced by the _aaaa_iiii_oooo_cccc_bbbb_pppp argument. The functions return when the
  23.      operation is queued. If _oooo_pppp is _OOOO______SSSS_YYYY_NNNN_CCCC then all modified data and
  24.      attributes are forced to the physical medium. If _oooo_pppp is _OOOO______DDDD_SSSS_YYYY_NNNN_CCCC then only
  25.      all modified data is forced to the physical medium.
  26.  
  27.      The iocbp argument refers to an asynchronous I/O control block. The iocbp
  28.      value may be used as an argument to _aaaa_iiii_oooo______eeee_rrrr_rrrr_oooo_rrrr and _aaaa_iiii_oooo______rrrr_eeee_tttt_uuuu_rrrr_nnnn. When the
  29.      request is queued the error status for the operation shall be
  30.      _[[[[_EEEE_IIII_NNNN_PPPP_RRRR_OOOO_GGGG_RRRR_EEEE_SSSS_SSSS_]]]]. When the operation is complete the error status is changed
  31.      to reflect the result of the operation.
  32.  
  33.      The aaaaiiiiooooccccbbbb---->>>>aaaaiiiioooo____ssssiiiiggggeeeevvvveeeennnntttt defines how the calling process will be notified
  34.      upon I/O completion.
  35.  
  36.      If ssssiiiiggggeeeevvvv____nnnnoooottttiiiiffffyyyy is SSSSIIIIGGGGEEEEVVVV____NNNNOOOONNNNEEEE, then no notification will be posted to the
  37.      calling application.
  38.  
  39.      If ssssiiiiggggeeeevvvv____nnnnoooottttiiiiffffyyyy is SSSSIIIIGGGGEEEEVVVV____SSSSIIIIGGGGNNNNAAAALLLL, then the signal specified in ssssiiiiggggeeeevvvv____ssssiiiiggggnnnnoooo
  40.      will be sent to the calling process. If SSSSAAAA____SSSSIIIIGGGGIIIINNNNFFFFOOOO is set for the signal
  41.      (see ssssiiiiggggaaaaccccttttiiiioooonnnn((((2222))))) and the signal is in the range of SSSSIIIIGGGGRRRRTTTTMMMMIIIINNNN and
  42.      SSSSIIIIGGGGRRRRTTTTMMMMAAAAXXXX then the signal will be queued to the process and the value in
  43.      ssssiiiiggggeeeevvvv____vvvvaaaalllluuuueeee will be the ssssiiii____vvvvaaaalllluuuueeee in the generated signal.
  44.  
  45.      If ssssiiiiggggeeeevvvv____nnnnoooottttiiiiffffyyyy is SSSSIIIIGGGGEEEEVVVV____CCCCAAAALLLLLLLLBBBBAAAACCCCKKKK then the function ssssiiiiggggeeeevvvv____ffffuuuunnnncccc will be
  46.      called with ssssiiiiggggeeeevvvv____vvvvaaaalllluuuueeee as the argument. Only one callback will be called
  47.      at a time, however programs should be careful to note that a callback may
  48.      be run in parallel with the calling process.
  49.  
  50.      If ssssiiiiggggeeeevvvv____nnnnoooottttiiiiffffyyyy is SSSSIIIIGGGGEEEEVVVV____TTTTHHHHRRRREEEEAAAADDDD then the function ssssiiiiggggeeeevvvv____nnnnoooottttiiiiffffyyyy____ffffuuuunnnnccccttttiiiioooonnnn
  51.      will be called by a new thread (see pppptttthhhhrrrreeeeaaaaddddssss((((5555))))) with ssssiiiiggggeeeevvvv____vvvvaaaalllluuuueeee as the
  52.      argument.  This thread is created when the event arrives with the
  53.      attributes specified in ssssiiiiggggeeeevvvv____nnnnoooottttiiiiffffyyyy____aaaattttttttrrrriiiibbbbuuuutttteeeessss except that it is
  54.      automatically detached.  The calling process should ensure there are
  55.      sufficient resources to create the thread.
  56.  
  57.      All aaaaiiiioooo____ffffssssyyyynnnncccc(((()))) calls must supply a complete aaaaiiiiooooccccbbbb---->>>>aaaaiiiioooo____ssssiiiiggggeeeevvvveeeennnntttt
  58.      structure.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AAAAIIIIOOOO____FFFFSSSSYYYYNNNNCCCC((((3333))))                                                      AAAAIIIIOOOO____FFFFSSSSYYYYNNNNCCCC((((3333))))
  71.  
  72.  
  73.  
  74. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  75.      aio_write(3), lio_listio(3), aio_error(3), aio_return(3), aio_cancel(3),
  76.      pthreads(5).
  77.  
  78. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  79.      A value of 0 is returned to the calling process if the operation is
  80.      successfully queued; otherwise the function returns -1 and is set to
  81.      indicate the error.
  82.  
  83.      [EAGAIN]       The operation was not queued due to resource limitations
  84.  
  85.      [EBADF]        The _aaaa_iiii_oooo______ffff_iiii_llll_dddd_eeee_ssss was not a valid file descriptor open for
  86.                     writing
  87.  
  88.      [EINVAL]       A value other then _OOOO______DDDD_SSSS_YYYY_NNNN_CCCC or _OOOO______SSSS_YYYY_NNNN_CCCC was specified for _oooo_pppp.
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.